Skip to content

docs(spec): add v6 spec draft incorporating issues #717-#723#725

Merged
kys0213 merged 2 commits intomainfrom
spec/v6-evolution
Apr 5, 2026
Merged

docs(spec): add v6 spec draft incorporating issues #717-#723#725
kys0213 merged 2 commits intomainfrom
spec/v6-evolution

Conversation

@kys0213
Copy link
Copy Markdown
Owner

@kys0213 kys0213 commented Apr 5, 2026

Summary

핵심 신규 개념

  • Stagnation Detection: SimilarityJudge trait + CompositeSimilarity (Composite Pattern)로 outputs/errors 별도 유사도 분석. ExactHash, TokenFingerprint, NCD 3개 내장 Judge
  • Lateral Thinking: 5개 내장 페르소나(HACKER, ARCHITECT, RESEARCHER, SIMPLIFIER, CONTRARIAN)가 패턴별 사고 전환. include_str!로 바이너리 임베딩. 모든 retry에 lateral_plan 자동 주입
  • Daemon 모듈 분리: Orchestrator + Advancer·Executor(StagnationDetector→LateralAnalyzer)·HitlService·Evaluator
  • Phase 전이 캡슐화: QueueItem::transit() 메서드 강제, phase pub(crate)
  • Per-item evaluate: workspace 배치 → per-work_id 개별 LLM 판정
  • source_data: ItemContext에 serde_json::Value 추가 (OCP)
  • Dependency gate DB 기반: in-memory → DB 조회 (restart-safety)
  • hitl_terminal_action 타입 안전: Option<String> → Option<EscalationAction>

문서 구조

spec/draft/
  DESIGN-v6.md                  ← 전체 상태 흐름 + 설계 철학
  README.md                     ← 인덱스 + 이슈 매핑
  concerns/
    stagnation.md               ← NEW: Composite Similarity + Lateral Thinking
    daemon.md                   ← Executor 내부 체인, handle_failure 의사코드
    queue-state-machine.md      ← transit 캡슐화, lateral 기본 동작
    data-model.md               ← Persona enum, JudgeConfig, source_data
    datasource.md               ← source_data, escalation + stagnation
    cron-engine.md              ← per-item evaluate
    agent-workspace.md          ← per-item evaluate
    + 4 unchanged (agent-runtime, cli-reference, cross-platform, distribution)
  flows/
    03-issue-pipeline.md        ← Stagnation Analyzer 흐름
    04-failure-and-hitl.md      ← lateral plan 주입 예시, lateral report
    05-monitoring.md            ← lateral 타임라인 시각화
    + 2 unchanged (01-setup, 02-spec-lifecycle)

Related Issues

Closes #717, Closes #718, Closes #719, Closes #720, Closes #721, Closes #722, Closes #723

Test plan

  • 모든 문서 간 cross-reference 링크 확인
  • 7개 이슈의 수용 기준이 스펙에 빠짐없이 반영되었는지 체크
  • DESIGN-v6의 전체 상태 흐름 다이어그램이 각 concern 문서와 일치하는지 확인

🤖 Generated with Claude Code

kys0213 and others added 2 commits April 5, 2026 11:39
@kys0213 @claude
docs(spec): add v6 spec draft incorporating issues #717-#723
68a19a9 
Complete spec/draft/ with 18 documents forming a self-contained v6 spec set.

Key additions:
- Stagnation Detection with Composite Similarity (SimilarityJudge trait)
- Lateral Thinking with 5 built-in personas (include_str! embedded)
- Daemon internal decomposition (Advancer, Executor, HitlService)
- Phase transition encapsulation (QueueItem::transit)
- ItemContext source_data extension (OCP)
- hitl_terminal_action type safety (EscalationAction enum)
- Dependency gate DB-based (restart-safety)
- Evaluator per-item judgment

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kys0213 @claude
docs: add spec hierarchy rule and refine DESIGN-v6 abstraction level
823c507 
- Add .claude/rules/spec-hierarchy.md with paths: spec/**/*.md
  Defines L1(Design)/L2(Concern)/L3(Flow) layering rules
- DESIGN-v6: add Actor section (7 actors with roles)
- DESIGN-v6: add external system integration table (trait boundaries only)
- DESIGN-v6: remove concrete implementations (gh CLI, rusqlite etc.)
  from design level — delegated to concern documents

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kys0213 kys0213 merged commit a20f5bb into main Apr 5, 2026
4 checks passed
@kys0213 kys0213 deleted the spec/v6-evolution branch April 5, 2026 06:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment